home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audiofile / AFgetrate.z / AFgetrate
Encoding:
Text File  |  1998-10-20  |  4.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaaffffGGGGeeeettttRRRRaaaatttteeee((((3333ddddmmmm))))                                                  aaaaffffGGGGeeeettttRRRRaaaatttteeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      afGetRate, afGetVirtualRate - get the track/virtual sample rate for a
  10.      specified audio track from an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  14.  
  15.      ddddoooouuuubbbblllleeee aaaaffffGGGGeeeettttRRRRaaaatttteeee((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt ttttrrrraaaacccckkkk))))
  16.  
  17.      ddddoooouuuubbbblllleeee aaaaffffGGGGeeeettttVVVViiiirrrrttttuuuuaaaallllRRRRaaaatttteeee((((AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee ffffiiiilllleeee,,,, iiiinnnntttt ttttrrrraaaacccckkkk))))
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  20.      _f_i_l_e    is an AAAAFFFFffffiiiilllleeeehhhhaaaannnnddddlllleeee structure, previously created by a call to
  21.              aaaaffffOOOOppppeeeennnnFFFFiiiilllleeee(3dm).
  22.  
  23.      _t_r_a_c_k   is an integer which identifies the audio track in the file.
  24.  
  25.              Since all currently supported file formats contain exactly 1
  26.              audio track per file, the value AAAAFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTRRRRAAAACCCCKKKK should always be
  27.              used for this argument for now.
  28.  
  29. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  30.      aaaaffffGGGGeeeettttRRRRaaaatttteeee(((()))) returns a positive double-precision floating point value
  31.      which specifies the audio sample rate in Hz of the data in _t_r_a_c_k.
  32.      aaaaffffGGGGeeeettttVVVViiiirrrrttttuuuuaaaallllRRRRaaaatttteeee(((()))) returns a positive double-precision floating point
  33.      value which specifies the virtual audio sampling rate in Hz of the data
  34.      in _t_r_a_c_k as set by a previous call to aaaaffffSSSSeeeettttVVVViiiirrrrttttuuuuaaaallllRRRRaaaatttteeee(3dm).  -1.0 is
  35.      returned in case of error.
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      aaaaffffGGGGeeeettttRRRRaaaatttteeee(((()))) and aaaaffffGGGGeeeettttVVVViiiirrrrttttuuuuaaaallllRRRRaaaatttteeee(((()))) return, in Hz., the file and virtual
  39.      sampling rates, respectively, of the data associated with the specified
  40.      track in an audio file.  The sampling rate is returned as a double-
  41.      precision floating-point value.
  42.  
  43.      For example, a CD-quality audio track would return a sample rate value of
  44.      44100.0.
  45.  
  46. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  47.      aaaaffffGGGGeeeettttRRRRaaaatttteeee(((()))) may return any conceivable sampling rate. Programs should
  48.      check that the sampling rate of a file opened for reading is a value it
  49.      can deal with, or use the virtual rate setting to make it so.
  50.  
  51. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  52.      afOpenFile(3dm), afInitRate(3dm), afSetVirtualRate(3dm)
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.